Monster Media 1994 #2/Monster Media No. 2 (Monster Media)(1994).ISO/utils1/cat300.zip/SCAT.DOC

Text File | 1994-06-26 | 8KB | 177 lines

                                 Version 3.0

                  CAT.EXE is written, by me, Mark J. Ruskin.

                         (All Rights Reserved).

               This is the ShareWare version of CAT.EXE.

       No claims are made as to the program's suitability for any specific
   purpose.  The author disavows responsibility for any damages resulting
   from the use of this program.


  The "ShareWare" means if you use the program after a reasonable trial
  period, (30 days) please send me $10.00 for registration, so I can pay
  some bills too:

  Mark Ruskin
  1100 Westwood Dr.
  Tullahoma, TN 37388-2836
  Phone [phone] or 455-8208

  You can also leave me E-Mail on my Local BBS
  The ElkRiver BBS [phone] or 454-2295
  Thanks

  For the $10.00 registration fee you'll get the latest version of CAT,
  without the annoying message at the end , each time you use it. Or, after
  30 days the pause for 30 seconds after each time you run the program.
  That way it will run a little faster. You can also send in suggestions on
  modifications, and request any custom enhancements. If I can, I'll do the
  mods and send it to you as soon as possible. That way you'll get a standard
  version right away and a custom version, as soon as I can get it done,
  for only $10.00.

              Ok, the money part's over with, on with the DOCS.

  >>>>>>>>>>> YOU MUST USE THE INSTALL.EXE FILE FOR INSTALLATION <<<<<<<<<<<

  If you don't, the program will NOT run, as it won't be able to find it's
  DATA file. The Install program will list all the Drives/Directories in your
  PATH= statement, from your AUTOEXEC.BAT file, and let you choose which
  Drive/Directory you want to Install the program to.

  CAT came about because I don't care for the MS-DOS "DIR" command, and I
  didn't exactly like some of the alternatives I tried. So, I decided to
  write my on alternative! Easier said than done.

  System requirements:
  IBM PC/XT, AT or 100% compatible.
  A Hard Disk Drive.
  As far as memory requirements goes. If you've got a PC/XT with 256K of RAM
  you'll have no problems.

  The version of DOS should be at least 3.2 or better. I've tested it with
  version 3.3, 5.0, and 6.20, with no problems.

              Now, on to how it works, and how to work it.

  The program displays a directory listing of a disk and/or subdirectory,
  with the text centered.
  See the 3 Sample LST files for a look at how it lists.

  If your CATaloging a subdirectory, you won't get the two DIR files with
  periods. I've always disliked having these two files show up.

  The first line displays the disk name, if any, if not it says so.
  The second line displays the PathName. ie. Drive Letter\ and Path if a
  subdirectory.

  Next is a listing of file names, extension, size in bytes, size (in K-bytes),
  and date. It displays ALL files, System, Hidden, and DIR files.

          Remember about this when you CAT a Bootable disk.

  You'll get two different totals with CAT and the DOS, DIR command. This is
  because the DIR command Does Not include the two System files, IO.SYS and
  MSDOS.SYS. The difference in K-bytes between CAT and the DIR command is
  about 69K under MS-DOS 5.0. You'll also get a difference in total number
  of files listed. It will be two more using CAT than when you use the DIR
  command.

                    DIR Will Not list hidden files.

  At the end of the file list it tells you how many K-bytes used with how
  many files. I used the K-bytes,(1K-bytes = 1024 bytes), because I think
  it's a pain to figure how many K is used by dividing bytes by 1024. It's
  accurate to 2 decimal places (1/100th of a K), and I like it a lot better.

  Next, It tells you how many K-bytes are free on the disk and the total
  number of K-bytes the disk is able to hold when empty. If there aren't
  any files or directories on the disk it will tell you, the number of
  K-bytes free and total K-bytes the disk is able to hold will be the same.
  (M-bytes = MegaBytes, where apropriate)

  If you have an empty 360K disk and CAT it, it will tell you that there is
  354 K-bytes available on the disk. Believe me, that's how many K-bytes
  there actually is on a formatted 360K disk, if it doesn't have any files
  or bad blocks.
  You can check it out if you want. If you divide 362,496 by 1024, you'll
  get 354 even.

                   Enough about K-bytes and bytes.

                >>What you can control in the program.<<

  While it's listing files in a directory or on a disk's root directory,
  you can:

  Press "Q" or "q" to halt and quit.

  Press any ASCII (alfa-numeric) key to pause it. Press another ASCII key to
  continue scrolling.

  Press an Extended key, after pausing, to scroll one line at a time.
  ie. Press an ASCII key to pause, and a Function key (F1 thru F10) or an
  Arrow key, and the display will scroll one more line, listing the next
  file in the directory. If there is a next file. You can do this down to
  the last file in the direcory. After the last file is listed it displays
  the totals and then displays the annoying message, pleading for the
  registration fee.

  If you want to CAT another disk and/or directory, include it on the
  command line.

  ie. "CAT C:\BIN\XTRAS" would CATalog the "XTRAS" directory on drive C: in
  the "BIN" directory.
  If you just want to catalog another disk's default Directory, you don't
  have to  put the colon or back slash. "CAT C" is the same as "CAT C:".
  If the default directory is not the Root Directory, and you want to
  CATalog the Root, then you need to add the colon and back slash.

  If the default directory is "C:\BIN", and you want to CATalog the Root
  Directory, you would have to include the colon and back slash.
  ie. "CAT C:\".

  You can also give a file to list or a file Type ie: CAT *.ZIP would list
  all the ZIP files in the current directory. Or CAT COMMAND.COM would list
  only the file COMMAND.COM, if it was in the current directory.

  Another mod I've done was to add a paging switch. This will cause CAT to
  pause after each screen full of listings and at the bottom of the screen
  tell you to "Q to Quit", If you hit any key but Q or q it will display the
  next screen of listings. To do this: CAT / or CAT *.ZIP /. The '/' (forward
  slash) is the paging switch.

  If you want to redirect the listing to a file instead of the screen:
  CAT ? D:\DRV_C.LST would CATalog the current drive/directory to the file
  on drive D: with a file name of DRV_C.LST. The '?' is the Save To File
  switch. You can also us the '?' with a file spec, ie:

  CAT C:\UTIL *.BAT ? D:\UTIL_BAT.LST

  This would list all the BAT files in "C:\UTIL\" and save the listing to
  the file named "UTIL_BAT.LST" in the Root Directory of drive D:\.
  I've included some sample listings I made with CAT and the '?' redirector
  switch. (SAMPLE1, 2, & 3.LST)
  (I tried to us the '>' key like DOS does, but DOS got in the way
  because it is a redirector switch for DOS, Oh Well).

  CAT now displays both the bytes and K-bytes for each file, unless it's a
  subdirectory file. I've also modified the K-bytes listing to show up as
  an 'M' if the file is = or greater than 1.0 Megabytes. In other words, if
  a file is 1048576 bytes or more it will show up as 1.00 M in the K-bytes
  column instead of 1024 K. I did this mainly because of my STACKER.000 files
  being multi-Megabytes in size and messing up my columns with the K-bytes
  being so large.

  Well, that's about all there is to it. I hope you find my first
  contribution to the world of programming useful.

  Enjoy,

  Mark J. Ruskin